home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / wbadaddr.z / wbadaddr
Encoding:
Text File  |  2002-10-03  |  3.7 KB  |  67 lines
  1.  
  2.  
  3.  
  4. wwwwbbbbaaaaddddaaaaddddddddrrrr((((DDDD3333XXXX))))                                                    wwwwbbbbaaaaddddaaaaddddddddrrrr((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _wwww_bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr - test for valid output bus address
  10.      _wwww_bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr______vvvv_aaaa_llll - test for valid output bus address and write value
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_yyyy_ssss_tttt_mmmm_...._hhhh_>>>>
  14.      _iiii_nnnn_tttt _wwww_bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr_((((_vvvv_oooo_llll_aaaa_tttt_iiii_llll_eeee _vvvv_oooo_iiii_dddd _****_a_d_d_r_,,,, _iiii_nnnn_tttt _s_i_z_e_))))_;;;;
  15.      _iiii_nnnn_tttt _wwww_bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr______vvvv_aaaa_llll_((((_vvvv_oooo_llll_aaaa_tttt_iiii_llll_eeee _vvvv_oooo_iiii_dddd _****_a_d_d_r_,,,, _iiii_nnnn_tttt _s_i_z_e_,,,, _vvvv_oooo_iiii_dddd _****_p_t_r_))))_;;;;
  16.  
  17.    AAAArrrrgggguuuummmmeeeennnnttttssss
  18.      _a_d_d_r The physical memory address of the location to be tested.
  19.  
  20.      _s_i_z_e The size in bytes of the location to be written: 1, 2, 4, or 8.
  21.  
  22.      _p_t_r  A pointer to a value of the appropriate size (char, short, int, or
  23.           long long) whose value is written to the given location.
  24.  
  25. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.      Typically these functions are called from a VME device driver's _iiii_nnnn_iiii_tttt(D2)
  27.      or _eeee_dddd_tttt_iiii_nnnn_iiii_tttt(D2) function to determine whether a device is present in the
  28.      system.
  29.  
  30.      Call _wwww_bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr to determine whether you can write to location _a_d_d_r.  It
  31.      writes a binary zero of the specified _s_i_z_e.
  32.  
  33.      Call _wwww_bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr______vvvv_aaaa_llll when you also want to specify the data to be written.
  34.  
  35.      Use _bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr(D3X) to test a location for input only.
  36.  
  37. NNNNOOOOTTTTEEEESSSS
  38.      If an invalid _s_i_z_e is passed a system panic results.
  39.  
  40.      For some systems, _pppp_iiii_oooo______wwww_bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr(D3X) must be used in order to perform
  41.      address mapping.
  42.  
  43.      It is possible that the _wwww_bbbb_aaaa_dddd_aaaa_dddd_dddd_rrrr______vvvv_aaaa_llll(D3X) function may change or be
  44.      removed in the future.
  45.  
  46.      These routines may not be called from an interrupt handler, or routines
  47.      that may be called from an interrupt handler.
  48.  
  49.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  50.      Both functions return 0 when _a_d_d_r is writeable.  Otherwise, they return
  51.      1.
  52.  
  53.    SSSSeeeeeeee AAAAllllssssoooo
  54.      badaddr(D3X), edtinit(D2), pio_wbadaddr(D3X).
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.